home *** CD-ROM | disk | FTP | other *** search
/ Total Network Tools 2002 / NextStepPublishing-TotalNetworkTools2002-Win95.iso / Archive / Misc Servers / Zope.exe / OBJECTREF.PY < prev    next >
Encoding:
Python Source  |  1999-04-13  |  7.6 KB  |  216 lines
  1. ##############################################################################
  2. # 
  3. # Zope Public License (ZPL) Version 1.0
  4. # -------------------------------------
  5. # 
  6. # Copyright (c) Digital Creations.  All rights reserved.
  7. # 
  8. # This license has been certified as Open Source(tm).
  9. # 
  10. # Redistribution and use in source and binary forms, with or without
  11. # modification, are permitted provided that the following conditions are
  12. # met:
  13. # 
  14. # 1. Redistributions in source code must retain the above copyright
  15. #    notice, this list of conditions, and the following disclaimer.
  16. # 
  17. # 2. Redistributions in binary form must reproduce the above copyright
  18. #    notice, this list of conditions, and the following disclaimer in
  19. #    the documentation and/or other materials provided with the
  20. #    distribution.
  21. # 
  22. # 3. Digital Creations requests that attribution be given to Zope
  23. #    in any manner possible. Zope includes a "Powered by Zope"
  24. #    button that is installed by default. While it is not a license
  25. #    violation to remove this button, it is requested that the
  26. #    attribution remain. A significant investment has been put
  27. #    into Zope, and this effort will continue if the Zope community
  28. #    continues to grow. This is one way to assure that growth.
  29. # 
  30. # 4. All advertising materials and documentation mentioning
  31. #    features derived from or use of this software must display
  32. #    the following acknowledgement:
  33. # 
  34. #      "This product includes software developed by Digital Creations
  35. #      for use in the Z Object Publishing Environment
  36. #      (http://www.zope.org/)."
  37. # 
  38. #    In the event that the product being advertised includes an
  39. #    intact Zope distribution (with copyright and license included)
  40. #    then this clause is waived.
  41. # 
  42. # 5. Names associated with Zope or Digital Creations must not be used to
  43. #    endorse or promote products derived from this software without
  44. #    prior written permission from Digital Creations.
  45. # 
  46. # 6. Modified redistributions of any form whatsoever must retain
  47. #    the following acknowledgment:
  48. # 
  49. #      "This product includes software developed by Digital Creations
  50. #      for use in the Z Object Publishing Environment
  51. #      (http://www.zope.org/)."
  52. # 
  53. #    Intact (re-)distributions of any official Zope release do not
  54. #    require an external acknowledgement.
  55. # 
  56. # 7. Modifications are encouraged but must be packaged separately as
  57. #    patches to official Zope releases.  Distributions that do not
  58. #    clearly separate the patches from the original work must be clearly
  59. #    labeled as unofficial distributions.  Modifications which do not
  60. #    carry the name Zope may be packaged in any form, as long as they
  61. #    conform to all of the clauses above.
  62. # 
  63. # 
  64. # Disclaimer
  65. # 
  66. #   THIS SOFTWARE IS PROVIDED BY DIGITAL CREATIONS ``AS IS'' AND ANY
  67. #   EXPRESSED OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
  68. #   IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
  69. #   PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL DIGITAL CREATIONS OR ITS
  70. #   CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
  71. #   SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
  72. #   LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF
  73. #   USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
  74. #   ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
  75. #   OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
  76. #   OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
  77. #   SUCH DAMAGE.
  78. # 
  79. # 
  80. # This software consists of contributions made by Digital Creations and
  81. # many individuals on behalf of Digital Creations.  Specific
  82. # attributions are listed in the accompanying credits file.
  83. # 
  84. ##############################################################################
  85. """Object Reference implementation"""
  86.  
  87. __version__='$Revision: 1.5 $'[11:-2]
  88.  
  89.  
  90. import sys, os, string, Globals, Acquisition
  91. from HelpUtil import HelpBase, classobject
  92. from HelpUtil import is_class, is_module
  93. from Globals import HTMLFile
  94. from urllib import quote
  95.  
  96.  
  97.  
  98.  
  99. class ObjectItem(HelpBase, classobject):
  100.     """ """
  101.     __roles__=None
  102.  
  103.     hs_main=HTMLFile('objectitem', globals())
  104.  
  105.     hs_cicon='HelpSys/hs_dnode'
  106.     hs_eicon='HelpSys/hs_dnode'
  107.  
  108.     def hs_id(self):
  109.         return self._obj_.meta_type
  110.  
  111.     def hs_url(self):
  112.         return quote(self._obj_.meta_type)
  113.     
  114.     hs_title=hs_id
  115.  
  116.     def __getattr__(self, name):
  117.         if name in ('isDocTemp', '__call__'):
  118.             raise AttributeError, name
  119.         return getattr(self.__dict__['_obj_'], name)
  120.  
  121.     def get_method_list(self):
  122.         rdict=classobject.get_method_dict(self)
  123.         perms=self.__ac_permissions__
  124.         mdict={}
  125.         mlist=[]
  126.         for p in self.__ac_permissions__:
  127.             pname=p[0]
  128.             fnames=p[1]
  129.             for fname in fnames:
  130.                 if rdict.has_key(fname):
  131.                     fn=rdict[fname]
  132.                     fn.permission=pname
  133.                     mdict[fname]=fn                    
  134.         keys=mdict.keys()
  135.         keys.sort()
  136.         for key in keys:
  137.             fn=mdict[key]
  138.             if not hasattr(fn._obj_, '__doc__'):
  139.                 continue
  140.             doc=fn._obj_.__doc__
  141.             if hasattr(fn._obj_, '__class__') and \
  142.                fn._obj_.__class__.__doc__ is doc:
  143.                 continue
  144.             
  145.             mlist.append(mdict[key])
  146.         del rdict
  147.         del mdict
  148.         return mlist
  149.  
  150.     hs_objectvalues__roles__=None
  151.     def hs_objectvalues(self):
  152.         return []
  153.  
  154.     
  155.  
  156. class ObjectRef(HelpBase):
  157.     """ """
  158.     __names__=None
  159.     __roles__=None
  160.  
  161.     hs_main=HTMLFile('objectref', globals())
  162.  
  163.     hs_cicon='HelpSys/hs_cbook'
  164.     hs_eicon='HelpSys/hs_obook'
  165.  
  166.     hs_id   ='ObjectRef'
  167.     hs_title='Object Reference'
  168.     hs_url  =hs_id
  169.     
  170.     def hs_deferred__init__(self):
  171.         # This is necessary because we want to wait until all
  172.         # products have been installed (imported).
  173.         dict={}
  174.         for k, v in sys.modules.items():
  175.             if v is not None and k != '__builtins__':
  176.                 dict=self.hs_search_mod(v, dict)
  177.         keys=dict.keys()
  178.         keys.sort()
  179.         __traceback_info__=(`dict`,)
  180.         for key in keys:
  181.             setattr(self, key, dict[key])
  182.         self.__names__=keys
  183.  
  184.     def hs_search_mod(self, mod, dict):
  185.         # Root through a module for things that look like
  186.         # createable object classes.
  187.         hidden=('Control Panel', 'Principia Draft', 'simple item',
  188.                 'Broken Because Product is Gone')
  189.         for k, v in mod.__dict__.items():
  190.             if is_class(v) and hasattr(v, 'meta_type') and \
  191.                hasattr(v, '__ac_permissions__'):
  192.                 if callable(v.meta_type):
  193.                     try: meta_type=v.meta_type()
  194.                     except:
  195.                         # Ack. probably a ZClass :(
  196.                         meta_type=None
  197.                 else: meta_type=v.meta_type
  198.                 if (meta_type is not None) and (meta_type not in hidden):
  199.                     dict[meta_type]=ObjectItem(k, v)
  200.             if is_module(v) and hasattr(v, '__path__'):
  201.                 dict=self.hs_search_mod(v, dict)
  202.         return dict
  203.  
  204.     hs_objectvalues__roles__=None
  205.     def hs_objectvalues(self):
  206.         if self.__names__ is None:
  207.             self.hs_deferred__init__()
  208.         items=[]
  209.         for id in self.__names__:
  210.             items.append(getattr(self, id))
  211.         return items
  212.  
  213.     def __getitem__(self, key):
  214.         return self.__dict__[key].__of__(self)
  215.  
  216.